"""
wow-python
==========

wow-python is a Python library designed to interface developers with
the World of Warcraft Armory.

Example (future) usage: ::

  import wow
  
  api = wow.API('eu')  # all future requests are now bound to the European Armory by default
  
  chars = api.search_chars('Whoever',
      key=lambda char: char.klass == 'Hunter'  # filter the results, so we only get Hunters named 'Whoever'
  )
  char = api.get_char(chars[0].name, chars[0].realm)  # full lookup of the first result

(...)

"""

from wow.api import API

__version__ = '0.1.0alpha1'
